7.2.1 创建数字币任意金额扫码支付订单

#简要描述：数字币充值业务接口，用户通过扫描二维码的方式将 USDT（Tether）充值到他们的数字钱包账户（市场汇率）

请求方式: POST
请求接口: https://网关域名/wallet-trade-merchant/v1/receive/blockchain/any/create
请求媒体类型( JSON 数据格式 )Content-Type: application/json

请求参数

参数名称	类型	必填	参数含义	参数说明
key	string	是	商户 key	apiKey
localOrderId	string	是	商户平台本地订单号	商户平台本地生成唯一订单号
localUserId	string	否	商户平台本地用户ID	商户平台本地用户ID
notifyUrl	string	否	回调地址	下单成功后，由 API 回调通知商户的地址（回调详情参照文档3）
successRedirectUrl	string	否	跳转地址	成功后自动跳转地址
currency	string	是	订单计价币种	计价币种(钱包支持币种)
userCurrency	string	是	用户支付币种	需要用户支付的币种(钱包支持的数字币种)
amount	number	否	用户预计支付金额
isBlockchain	boolean	否	是否返回区块链信息（默认false）	当为true时，回调请求会携带订单链上交易信息
networkLimits	array	否	主网	指定的支付主网，如 TRON、BSC、POLYGON、ETHEREUM
expireSecond	Long	否	过期时间戳（秒）
sign	string	是	签名	详情见签名算法

请求 json 样例

{
  "key": "9yUreYgTRtit39Dy",
  "localOrderId": "1732322-111",
  "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify",
  "amount": 8,
  "currency": "USDT",
  "userCurrency": "USDT",
  "networkLimits": ["TRON"],
  "isBlockchain": true,
  "sign": "6c82150ae89fc0fa202f98c92023ef04"
}

响应 json 示例

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 274185964909271,
    "localUserId": null,
    "localOrderId": "1732322-111",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_ANY_USDT_WALLET_SCAN",
    "paymentUrl": "https://walletapi.vapyapp.com/any-amount-pay/NanZCtCLCcFQbqbPyy3KJkFPYNTaZGuGjyibkAVjVuebjHWi2QuVrM5QUxg4",
    "publicKey": "NanZCtCLCcFQbqbPyy3KJkFPYNTaZGuGjyibkAVjVuebjHWi2QuVrM5QUxg4"
  }
}

返回的 paymentUrl 弹出支付页面，如下图：

响应data 参数说明

参数名称	类型	参数含义	参数说明
orderId	string	订单 ID
localUserId	string	商户本地用户 ID
localOrderId	string	商户本地订单号
orderType	enum	订单类型	`PAYMENT:支付订单 WITHDRAW:提款订单`
orderBizType	enum	订单业务类型	orderBizType 类型说明如下
paymentUrl	string	支付地址
publicKey	string	公共访问密钥

orderBizType 类型说明：

1、PAYMENT_WALLET_SCAN VAPY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至VAPY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付

回调返回 json 数据

默认所有回调参数参与验签，回调参数详情请看回调

回调 data

{
  "amount": 8,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "USDT",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT",
  "userReceivableAmount": 1.55
}

当您收到回调通知后，请在处理完成后直接返回字符串 success，表示已成功接收并处理该消息。系统在收到 success 响应后，将不再对该笔回调进行重复发送。若未收到期望响应（未返回 success 或返回异常），系统将按照阶梯式重试机制重新发送回调通知，最多重试 14 次。当前重试时间间隔依次为： 15s, 15s, 30s,180s, 600s, 1200s, 1800s, 1800s, 1800s,3600s,10800s,10800s,21600s, 21600s

请求参数​

请求 json 样例​

响应data 参数说明​

orderBizType 类型说明：​

回调返回 json 数据​